Shareware Super Platinum 8/Shareware Super Platinum 8.iso/mac/WIN_PRO/WINDOW.ZIP;1/WINDOW.DOC

Text File | 1990-05-19 | 11.4 KB | 242 lines

                               WINDOW.EXE v1.0
                              By: Mike Wheaton
                                Documentation

Date: 05-19-1990

DESCRIPTION:
      WINDOW.EXE was designed as a batch file WINDOWing program to add a
   little pazzaz to your batch files.  The program easily allows the user
   to create pop-up windows within a batch file for displaying messages as
   to what is being performed, and why, etc...
      WINDOW also has MANY options available, including, saving and
   restoring previous screens, Exploding (growing) windows, automatic
   shadowing, clear screen, displaying text, and user defined colors for
   any window.
      This program performs it's best, when running on a 80286 machine, with
   EGA or VGA graphics, but WILL run on ANY true IBM compatible machine with
   ANY monitor configuration.

WARRANTY &
DISCLAIMER:
      The author makes NO warranties, expressed or implied, as to the quality
   or performance of this program.  The author will NOT be held liable for any
   direct, indirect, incidental, or consequential damage resulting from the
   use of this program.  Your use of this program, constitutes your agreement
   to this disclaimer and your release of the author from any form of
   liability or litigation.

USE:
      The file WINDOW.EXE should be copied to any directory within your path.
   This will make the window program fully accessable from any drive or
   directory.
   See your DOS manual for information on PATH.
      The proper syntax to run window, is as follows;

   WINDOW 5, 8, 20, 60, 14, 1, cls, explode, shadow

          ≥  ≥  ≥   ≥   ≥   ≥   ≥   ≥        ≥
          ≥  ≥  ≥   ≥   ≥   ≥   ≥   ≥        ¿ƒ Automatic shadows. If not used
          ≥  ≥  ≥   ≥   ≥   ≥   ≥   ≥           it may be left blank.
          ≥  ≥  ≥   ≥   ≥   ≥   ≥   ≥
          ≥  ≥  ≥   ≥   ≥   ≥   ≥   ¿ƒ Creates an Exploding (growing) window.
          ≥  ≥  ≥   ≥   ≥   ≥   ≥      If not used, you MUST use "" as a
          ≥  ≥  ≥   ≥   ≥   ≥   ≥      place holder.
          ≥  ≥  ≥   ≥   ≥   ≥   ≥
          ≥  ≥  ≥   ≥   ≥   ≥   ¿ƒ This will Clear the screen before displaying
          ≥  ≥  ≥   ≥   ≥   ≥      the window. If not used, you MUST use "" as
          ≥  ≥  ≥   ≥   ≥   ≥      a place holder.
          ≥  ≥  ≥   ≥   ≥   ≥
          ≥  ≥  ≥   ≥   ≥   ¿ƒ Background color. Valid responses are 0-7.
          ≥  ≥  ≥   ≥   ≥      See color chart below.
          ≥  ≥  ≥   ≥   ≥
          ≥  ≥  ≥   ≥   ¿ƒ Border color. Valid responses are 0-15. Colors
          ≥  ≥  ≥   ≥      16-31 will produce a blinking border.
          ≥  ≥  ≥   ≥      See color chart below.
          ≥  ≥  ≥   ≥
          ≥  ≥  ≥   ¿ƒ Ending X coordinate (column) for text to be displayed.
          ≥  ≥  ≥      Valid responses are 2-80 without shadow, or 4-80 with.
          ≥  ≥  ≥      This value MUST be at lease 2 greater than Starting X.
          ≥  ≥  ≥
          ≥  ≥  ¿ƒ Ending Y coordinate (row) for text to be displayed.
          ≥  ≥     Valid responses are 2-25 without shadow, or 2-24 with.
          ≥  ≥     This value MUST be at least 2 greater than Starting Y.
          ≥  ≥
          ≥  ¿ƒ Starting X coordinate (column) for text to be displayed.
          ≥     Valid responses are 2-78 without shadow, or 4-78 with.
          ≥
          ¿ƒ Starting Y coordinate (row) for text to be displayed.
             Valid responses are 2-23 without shadow, or 2-22 with.

      The Starting Y coordinate determines the mode of operation for the
   WINDOW program.
   Valid responses are as follows;

      ##           = Produce a window as stated above.
      text         = Used to display text in the window.
                     See DISPLAYING TEXT below.
      pause        = Used to wait for keyboard input, or ## secs.
                     to pause for a specific # of seconds and continue without
                     user response, the # of seconds should be placed in the
                     Starting X coodinate.
                     See PAUSEing below.
      save         = Used to save the current screen before displaying another
                     window.
                     See SAVING THE CURRENT SCREEN below.
      restore      = Used to restore a previously saved screen.
                     See RESTORING SCREENS below.
      filename.ext = You may create a data file for the window program
                     to use. This GREATLY increases the speed at which
                     the window program executes your commands.
                     This should be a simple text file, created with any
                     word processor capable of saving ASCII files, and should
                     contain all of the information normally passed to
                     the window program. eg...

                     6,19,10,60,14,1,cls,explode,shadow
                     text,7,22,11,1,Welcome the the ULTIMATE batch file
                     text,8,22,11,1,WINDOW program!
                     text,9,22,15,1,5 Second Delay.  Please Wait...
                     pause,5

                     NOTE: You do not include the program name WINDOW, within
                           the data file. This is because you are already
                           running the window program when it loads your data.

DISPLAYING TEXT:
      Text may be placed anywhere on the screen with WINDOW, and in any color.
   The syntax for using WINDOW to display text is as follows;

   WINDOW text, 8, 20, 14, 1, Text to display

          ≥     ≥  ≥   ≥   ≥  ≥
          ≥     ≥  ≥   ≥   ≥  ¿ƒ Any Text as you want it to appear.
          ≥     ≥  ≥   ≥   ≥
          ≥     ≥  ≥   ≥   ¿ƒ Background color. Valid responses are 0-7.
          ≥     ≥  ≥   ≥      This should match the Background color of the
          ≥     ≥  ≥   ≥      window.
          ≥     ≥  ≥   ≥
          ≥     ≥  ≥   ¿ƒ Foreground color. Valid responses are 0-15. Colors
          ≥     ≥  ≥      16-31 will produce a blinking text.
          ≥     ≥  ≥
          ≥     ≥  ¿ƒ X coordinate (column) for text to be displayed.
          ≥     ≥     Valid responses are 1-80.
          ≥     ≥
          ≥     ¿ƒ Y coordinate (row) for text to be displayed.
          ≥        Valid responses are 1-25.
          ≥
          ¿ƒ This is simply the word "text". (case is un-important)
             It is used to tell the WINDOW program you want to display text
             as apposed to drawing a window.

PAUSEing:
      If you are using a data file for creating displays, this may be used
   to pause for user input, or you may elect to pause for 5 seconds and then
   continue without waiting for a response. This is useful when designing
   self-running demos.
      The syntax for using WINDOW to pause for input is as follows;

   WINDOW pause, 8

          ≥      ≥
          ≥      ≥
          ≥      ¿ƒ Used for the # of seconds to pause.  Leave this off
          ≥         if you desire user input to continue.
          ≥
          ¿ƒ This is simply the word "pause". (case is un-important)
             It is used to tell the WINDOW program you want to pause, and
             wait for user input, or a specific # of seconds.

SAVING THE CURRENT SCREEN:
      Any screen may be SAVED and then restored at a later time, which allows
   for a TRUE WINDOWing effect. All screens SAVED, are saved to disk, so this
   may be slow on a floppy system. Each screen requires 4K of disk space.
   This does, however, allow for a lot of posibilities. Multiple screens may
   be saved at one time, and then restored in any order.  Or you may elect to
   wait and RESTORE a screen TOMORROW!
      The syntax for using WINDOW to SAVE the current screen is as follows;

   WINDOW save, 1

          ≥     ¿ƒ This is an optional # of the screen to save. You may save
          ≥        as many as 10 screens. If this number is left blank, WINDOW
          ≥        will assume you are saving screen #1.
          ≥        This option is handy if you are displaying several screens
          ≥        and then backing up through them.
          ≥
          ¿ƒ This is simply the word "save". (case is un-important)
             It is used to tell the WINDOW program you want to save a screen.

RESTORING SCREENS:
      Any previously SAVED screen may be easily RESTORED. You may produce a
   TRUE WINDOWing effect by displaying a window, saving the screen, displaying
   another window over it, and then restoring the previously saved screen. As
   a screen is RESTORED, it's disk file is deleted.
      The syntax for using WINDOW to RESTORE a screen is as follows;

   WINDOW restore, 1

          ≥        ¿ƒ This is an optional # of the screen to restore. If a
          ≥           screen was saved with a number other than 1, you MUST
          ≥           include the number of the screen to restore here.
          ≥
          ¿ƒ This is simply the word "restore". (case is un-important)
             Used to tell the WINDOW program you want to restore a screen.

USING A DATA FILE:
      WINDOW will read in a data file that you have created and execute the
   commands with MUCH GREATER SPEED than running the WINDOW program for each
   window displayed.  This is ONLY usefull if you are executing several
   WINDOW commands in a row.
      The syntax for telling WINDOW to use a data file is as follows;

   WINDOW filename.ext

          ¿ƒ This is the file name of the data file for WINDOW to load.
             If you do not use an extension on the filename, you MUST still
             use the period after the filename here.
             For an example of a WINDOW data file, see the sample WIND.DAT.

------------------------------------------------------------------------------
COLOR CHART:
      The following is a color chart for the border, text, and background
   colors used by the WINDOW program;

      BORDER & TEXT:
         0 = Black                       8 = Grey
         1 = Blue                        9 = Bright Blue
         2 = Green                      10 = Bright Green
         3 = Cyan                       11 = Bright Cyan
         4 = Red                        12 = Bright Red
         5 = Magenta                    13 = Bright Magenta
         6 = Brown                      14 = Yellow
         7 = White                      15 = Bright White

      By adding 16 to any of the above numbers, causes that color to blink.

      BACKGROUND:
         0 = Black
         1 = Blue
         2 = Green
         3 = Cyan
         4 = Red
         5 = Magenta
         6 = Brown
         7 = White

      Any Background above 7 will cause the text or border to blink.
------------------------------------------------------------------------------

      This Program is brought to you by Mike Wheaton.
   WINDOW.EXE has been released to Public Domain on 5-19-1990.
   The Author requires NO registration fee or donations. Use it and enjoy.
   If you have any suggestions for improvement, bug notifications, etc, please
   address them to;
                            Mike Wheaton
                            211 Seventh Ave.
                            Mansfield, OH  44905

   You may also call The DK Jet-Works BBS and leave a message for the SysOp.
   Supporting 300-2400 Baud. 24 Hours a day. [phone]